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BALLY BASIC HACKER’S GUIDE 

This report describes features provided in the Bally Basic Cassette, 

Out not .documented in the programmed instruction course booklet’. 

Some of these features may be removed to make way for other improve- 
ments 

ABS FUNCTION 

The absolute value function is available. It is typed in as 3 discrete 
keystrokes: "A", "B", and "S". 

STOP COMMAND 

The STOP command halts the program. It is typed in as 4 discrete 
keystrokes . 

RM 

The special variable RM has its value the remainder produced by 
the most recently executed integer division operation. 

This example prints M mod 256 
1 0 A = M f 256 
20 PRINT RM 
XY 

This variable remembers the X, Y position specified in the latest 
LINE command. The Y value occupies the high order byte of this word; X 
the lower byte. 

CALL N 

The CALL command transfers control to an assembly language subroutine. 
This routine should terminate by executing'a RET instruction. Register DE 
contains a pointer to the I i ne being executed. If needed it should be saved 
then restored before returning to Bally Basic. 

Examp I e : 



500 CALL 0 



(Self Destruct Reset) 




: RUN Command 

Used to load a 128 byte boostrap routine from the Bally Basic Cassette 
tape Interface. This bootstrap loads into screen memory beginning at 
address 4000, . Execution begins there when the load is completed. This 
feature was provided to allow short assembly language programs to be loaded 
from tape. 

A transfer vector to the get character from tape routine is located 

at 20 I A . c . The character comes back in A. 

I o 

BALLY BASIC provides special commands for interfacing to the resident 
calculator program. These commands allow the addition, subtraction, 
multiplication and division of 16 digit numbers with eight digits on 
either side of the decimal point. 

NUMBER REPRESENTATION 

The @() array is used to store the numbers operated on by these 
commands. Eighteen consecutive § elements are used, one per digit. (The 
two extra digits are for sign and overflow indicators). The assignment 
of digit positions to array elements, looks like this: 

RELATIVE DIGIT POSITIONS 

0 

1 

2 

3 

4 
■5 
6 

7 

8 
9 



digit 


10 8 


digit 


IQ" 7 


digit 


I0 -6 


digit 


I0~ 5 


digit 


io ~ 4 


digit 


io -3 


digit 


io -2 


digit 


10“' 


digit 


■ .0° 


digit 


io 1 







RELATIVE DIGIT POSITIONS 



10 ' 


digit 


ICT 


1 1 


digit 


io J 


12 


digit 


io 4 


13 


. digit 


io 5 


14 


digit 


io 6 


15 


digit 


IO 7 


16 


overflow, indicator * (nan-zero if overflowed) 


17 


sign (0 if 


positive, 8 if negative) 


*overf 1 ow 


i nd i cator must 


be initialized to 0 on command entry 



The digits may be represented as binary numbers between 0 and 9 or 
as ASCII character codes between 48 and 57. The result is always ASCII. 

This example sets up 3.14159 beginning at @(0). 

10 FOR A = 0 to 1 8 ; , clear everything 

20 @CA) = 0 

30 Next A 

40 @ ( 8 ) = 3 

50 @(7) = I 

60 @(6) = 4 

70 @(5) = I 

80 @ (4 ) = 5 

90 @(3) = 9 

COMMAND FORM 

All four commands resemble this addition command example: 

100$+ @(0), @( 18), @(36) 

which means "Add the number starting at @(0) to the number at @(18) and 
store the result beginning at @(36)". 




Examp I es 



of the others 



S-C(A), @(B), §(B) subtraction 

i-xi(0) , @(0), @(0) multiplication 

$ 7 @(X), @(K), @(N) division 

This example prints the sequence I, 2, 4, 8, etc. 
10 FOR A = 0 to 17; . INITIALIZE 
20 3(A) - 0 
30 NEXT A 

40 @(8) = I ; . start at I 
50 GOSUB 1000 ; . CALL PRINT ROUTINE 
60 $ j-@ ( 0 ) , @ ( 0 ) , @ ( 0 ) ; , DOUBLE NUMBER 
70 GOTO 50 
80 

1000 Z = I ; . SET LEADING ZERO FLAG 
1010 IF 0(17) = "8" PRINT 
1020 FOR B = 16 to 9 STEP - I 
1030 IF g(B) = "0" IF Z GOTO 1060 
1040 Z = 0 
1050 TV = @(B) 

1060 NEXT B 
1070 TV = @( 8) 

1080 PRINT 



1090 RETURN 




10 PORT AND MEMORY ACCESS 

The physical 10 ports of the Arcade may be accessed through the 
3() construct. 

3() is used much like @(). For example: 

>3(23) = 255; 3(21 ) = 255 

sets ports 21 and 23 both equal to 255, which makes a rocket like sound. 
Ports may be read by using 30 in place of any expression. For example: 

10 PRINT 3( 23) 

20 GOTO 10 

will loop sampling and reporting the status of the leftmost column 
of keys on your easy-entry keypad. Press any key in that column and see 
what happens. Try combinations. 

The physical memory of the Arcade may be read or written in a similar 
way using %{) . This example prints the first hundred words of operating 
system ROM: 

10 FOR A = 0 to 198 STEP 2 
20 PRINT 0(A) 

30 NEXT A 

NEAT I/O PORTS 

Color control ports 
3(0) = COLOR 0 RIGHT VALUE 
3( I ) = COLOR I RIGHT VALUE 
& ( 2 ) = COLOR 2 RIGHT VALUE ■ 

3(3) = COLOR 3 RIGHT VALUE 

3(9) = HORIZONTAL COLOR BOUNDARY REGISTER 

3(10) = VERTICAL BLANK I NG REG I STEP 




The format of these values is the same as the codes used with FC and 
BG (color x 3 + intensity). 

These ports only have effect when the horizontal color boundary register 
is set to a value less than 44. This boundary register is set to the byte 
number of where to switch from one set of colors to the other. 

The colors for the left side of this boundary are defined by FC and BC. 

The following program demonstrates the ideas: 

10 0 ( 0 ) = 0 
20 6(1) - 123 
30 &(2) = 185 
40 0(3) = 251 
50 FOR A = 0 to 255 
60 0(9) = A 
70 NEXT A 
80 GOTO 50 

If you halt this program while the. black background is up and study the 
screen, you can see how the program is stored intermixed with the graphics. 
Try adding lines to the program. 

To hide the program but show graphics, set 0(0) and 0(1) to the back- 
ground color; 0(2) and 0(3) to the foreground color. 

The vertical blanking register, 0(10) specifies how many scan lines 
of graphics data are to be displayed. AM .lines below the specified 
ones are shown in the background color. This register acts I i ke a curtain 
which we can lower between acts. Its initial value is 176. Try 204 and 
watch Bally Basic's scratch storage area twinkle. 




HAND CONTROLS 



0(16) 


Player 1 


joystick 


& 


trigger 


&( 17) 


Player 2 


joyst i ck 


& 


tr i gger 


& ( IS) 


Player 3 


joyst i ck. 


& 


tr i gger 


<i( 19) 


Player 4 


joyst i ck 


& 


trigger 


ad ue returned looks 


1 i ke this: 








4 ■ 2^ 


? 

2“ 


2 1 




2° 



TRIGGER 
j .16 


R 1 GHT 

j 

i 

8 


1 LEFT 

4 


*) | 

; DOWN ! UP 

} \ 

1 2 i 1 

■ i s 


j 

1 

i 

i 

] 

i 

i 


& ( 28) 




Player 1 


knob position 




& (29 ) 




Player 2 


knob position 




& ( 30 ) 




Player 3 


knob position 




& ( 31 ) 




Player 4 


knob position * 





The value ranges from 0 (full clockwise) To 255 (full counterclockwise) 

KEYPAD SENSING 

While running a program you can check to see if a key has been pressed 
on the easy-entry keypad without going into wait. 



& ( 23 ) & ( 22 ) & ( 2 I ) &( 20 ) 

r ! i "1 ; f 

I ... 



i 



i 16 



32 



For example to check for the 5 key on the easy-entry keypad overlay: 

10 IF -'.(22) = 4 PRINT "5" 

20 GOTO 10 

LIGHT PEN INTERFACING 

&(I4) Y Coordinate position 

0(15) X Coordinate position 

These ports retain the coordinates of the most recent light pen hit. 

Light pen sampling must be turned on. This is done by issuing the 
: INPUT command which is normally used by the cassette tape interface. 

It is possible that the coordinates from & ( 1 4 ) and &(I5) may be off by 
a constant amount due to time delays in the light pen circuits. You 
should add or subtract the proper fudge factor for your light pen to translate 



into screen coordinates. 
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THE BALLY COMPUTER SYSTEM SOUND SYNTHESIZER 

The sound synthesizer can produce 3 tones at one time, with vibrato, 
noise, ana amplitude control. Bally Basic norma I I y . uses only one of the tone 
voices. By using the &() construct, all of the features of the synthesizer 

The synthesizer can be divided into two sections. The first section, 
on the left hand side of the block diagram, is concerned with controlling 
the master oscillator. The master oscillator output is input to the other 
section which contains the 3 voice oscillators. Thus changes made to the master 
osc ilia tor side of the synthes i zer effect all 3 voi ces . 

The master oscillator is a programmable frequency divider. It is a 
counter which is clocked at 1.789 Mhz. Each time it counts down to zero, 
the state of its output is toggled and the counter is reinitialized to 
the last value output to port 16. The master oscillator output is a 
square wave of frequency 1789 Khz / (port 16+1) 

By setting control' bits in port 21 the behavior of the master oscillator 
may be modified. Bit 4 when set causes noise to be added to the value output 
to port 16. This sum' is used to reset the counter in the master oscillator. 

The effect is that the frequency is varied by a random amount. The amount 
of variation i s contro I I ed by the noise amplitude port: &(23). 

Reseting bit 4 turns off noise modulation, and turns on vibrato. 

Vibrato works like noise modulation, except that the value added to port 16 
varies over a programmable range 0-63 (vibrato amplitude) the' rate at which 
this added value varies is determined by the vibrato frequency register, 
which can have four different values: 0 meaning fastest to 3 meaning slowest. 

The right side of the synthesizer consists of three frequency dividers 
(voices) with associated volume control registers. Each divider is clocked 




by the output of the master oscillator. The output frequency is given by 
the formula FV = FM 2(&(N)+I) 

where M is 17 for voice A, 18 for voice B, or 19 for voice C. FM 
is the frequency output by the master oscillator. Substituting in the 
formula for FM we have: 

FV = 894 Khz/ (& ( 16) M ) (&(N)+| ) 

Each voice has a 4 bit volume control register; 0 is quiet, 15 is full 
volume. The volume is linearly proportional to the value output. Unfortunately 
the volume control registers share physical port assignments with other' 
control bits. Voice A uses the lower 4 bits of &(22); voice B the upper 

4 bits. Voice C uses the lower 4 bits of &(2I), which also deals with noise 
control. See "Flow to deal with shared 10 ports" for explanation. While 
noise may be mixed in with the output of voices A, B, and C by setting bit 

5 of & ( 2 1 ) . The volume of this noise is determined by the upper four bits 
of &(23), the noise volume register. 

HOW TO DEAL WITH SHARED 10 PORTS 

The Bally Home Computer System has several shared 10 ports in its 
design. This means that several distinct registers are grouped into one 
10 port. For example: & ( 2 1 ) controls both the noise generator and the 
volume of Tone C. This design trick is a relic of the early days of micro- 
computers, when such shenanigans would save a TTL chip or two. 

The programmer must deal with this inconvenience by combining these 
distinct values together using an arithmetic expression. One easy way 
to do this is to multiply the higher order or leftmost value by the power 
of 2 of its rightmost bit position and then add in the other (right side) 



value. 




CHARACTER CODE TABLE 



;i 


CHARACTER 




■CHARACTER 


A 


CHARACTER - 


#_ 


CHARACTER 


Q 


O "-N 


32 


SPACE 


64 


@ 


96 


C- 


.1 


9 9 


33 


! 


65 


A 


97 


-> 


- 


? ? 


34 


M 


66 


B 


■ 98 


X(Multiply) 




? ° 


35 


# . 


67 


C 


99 


f 


4 


? ? 


36 


$ 


' 68 


D 


100 


?■? 


5 


? ? 


37 


a! 

P 


69 


E 


101 


? ? 


6 


?? 


38- 


& 


70 


F 


102 


? ? 


7 


?? 


39. 


' (apostrophe.) 


71 


G 


103 


?? 


8 


?? 


40 


( 


72 


H 


104 


LIST 


9 


?? 


41 


) 


73 


1 


105 


CLEAR 


10 


?? 


42 


* ■ 


74 


J 


106 


RUN 


1 1 


?? 


43 


+ 


75 


K 


107 


NEXT 


12 


■? ? 


44 




76 


L 


' 108 


LINE 


13 


GO 


45 


- 


77 


M 


109 


IF 


14 


? ? 


46 


. ( peri od ) 


78 


N 


1 10 


GOTO 


1 5 


?.?■ 


47 


/ 


79 


0 


1 1 I 


GOSUB 


16 


? ? 


48 


0 


80 


P 


i 12 


RETURN 


1 7 


? ? 


49 


1 


81 


Q 


1 1 3 


BOX 


18 


? 7 


50 


2 


82 


R 


1 14 


FOR 


19 


? 7 


51 


3 


83 


S 


1 15 


INPUT 


20 


?? 


52 


■ 4 


■ 84 


T 


I 16 


PRINT 


21 


? 7 


53 


5 


85 


U 


1 17 


STEP 


22 


? 7 


54 


6 


■ 86 


V 


1 18 


RND 


23 


?? 


55 


7 


87 


w 


1 19 


TO 


24 


? 7 


56 


8 


88 


X 


120 


?? 


25 


9 ° 


57 


9 


89 


Y 


121 


? ? 


26 


? ? 


58 




90 


Z 


122 


?? 


27 


? 7 


59 




91 


[ 


123 


?? 


28 


? ? 


60 




92 


\ 


124 


?? 


29 


? 7 


61 


= 


93 


] 


125 


?? 


30 


? 7 


62 




94 


A 

f 


126 


? ? 


31 


ERASE 


63 


? 


95 




1 27 


?? 




MEMORY AREAS OF INTEREST 



ON BOARD ROM- 

BALLY BASIC ROM- 

SCREEN MEMORY AREA- 

BALLY BASIC GRAPH I CS/- 

r ROGRAM AREA- 

BALLY BASIC SCRATCHPAD 
' • MEMORY AREA - 



DECIMAL 
0-8191 
8192-12287 
I 6384-20479 
I 6384- i 9983 



20000-20463 



HEX I DECIMAL 
0-1 FFF 
2000-2FFF 
4000-4FFF 
4000-4E I 0 



4E20-4FEF 



TAPE INPUT BUFFER - 


20002-20049 


VARIABLES BEGIN AT - 


20078 


LINE INPUT 'BUFFER 
( 1 04 characters ) - 


20180-20283 


STACK AREA - 


20284-20462 


TEXT AREA - 


24576-22777 


NOTE LOOKUP TABLE 


12046 



4E22-4E5 I 
4E6E 

4ED4-4F3B 
4F3C-4FEE 
0AOOO+0A7O7 
2F0E for CR ( I 3 j0 ) 
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R I 


- 270 


ohm 


R7 


- 100 


ohm 


R3 


- 47 


ohm 


R4 


- 100 


ohm 


R5 


- 51 K 


ohm 


R6 


- 1 OK 


ohm 


R7 


IM 


ohm 


R8 


- J OOK 


ohm 


R9 ■ 


- IOM 


ohm 


RIO' 


- 270 


ohm 


R 1 1 • 


- 330 K 


ohm 


RIB- 


- 1 50K 


ohm 


ALL 


ABOVE 


I/4W 5 j 


R 1 3- 


- 20K 


ohm trimpot 



CRI - IN4I48 
CR2 - IN4I48- 



Cl - 22mfd 6v Tantalum 

C2 - .1 mfd 

C3 - 100 pfd 

G4 - 100 pfd 

C5 - 100 pfd 

C6 - 470 pfd 

C7 - 470 pfd 

C8 - . I mfd bypass 

1C I - MCI4572UB 

IC2 - MCI40I5B 

I C'3 - MCI4070B 

IC4 - MCI4024B 

IC5 - MCI4503B 

IC6 - MCI40I3B 

IC7 - MCI4027B 

ICS - MCI 401 IB 

IC9 - MCI4024B 



CR3 - MV5754 LED 




